home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 176-200 / scopedisk185 / calc / calc.doc < prev    next >
Text File  |  1995-03-19  |  9KB  |  244 lines
  1.  
  2.  
  3.  
  4.  
  5.                             Calc V1.01  25-Mar-89
  6.           Copyright (c) 1989 Martin Taillefer, All Rights Reserved
  7.             This is freely redistributable (see conditions below)
  8.  
  9.  
  10.  
  11.  
  12.                           Copyright and Disclaimer
  13.                           ========================
  14.  
  15. Title to this software and all copies thereof remain vested in the author
  16. indicated in the above copyright notice.  Holders of this software are
  17. granted the right to reproduce and use the same for personal, non-commercial
  18. purposes.  All other rights are reserved.
  19.  
  20. NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE ACCURACY,
  21. RELIABILITY, PERFORMANCE, OR OPERATION OF THIS SOFTWARE, AND ALL SUCH USE IS
  22. AT YOUR OWN RISK.  THE AUTHOR DOES NOT ASSUME ANY RESPONSIBILITY OR LIABILITY
  23. WHATSOEVER WITH RESPECT TO YOUR USE OF THIS SOFTWARE.
  24.  
  25. For inquiries regarding distribution or commercial uses of this software,
  26. contact:
  27.  
  28.   Martin Taillefer
  29.   136 Des Frenes
  30.   Montreal, Quebec
  31.   CANADA   H1B 1X8
  32.  
  33.   TEL: 514/645-4083
  34.   BIX: vertex
  35.   CIS: 76004,2054
  36.  
  37.  
  38.  
  39.  
  40.                            Distribution Agreement
  41.                            ======================
  42.  
  43. This software product was written using the V1.00 M2Sprint development
  44. environment. It is copyrighted by the author but may be freely redistributed
  45. as long as the following conditions are respected:
  46.  
  47.   -To the exception of media charges, the software must be distributed free
  48. of charge.
  49.  
  50.   -The ZOO archive used to distribute the software must remain intact. All
  51. files distributed with the original archive must accompany further
  52. distributions in an un-altered state. Distribution of the software by Public
  53. Domain libraries is allowed in an un-archived format, as long as the totality
  54. of the files from the original archive be included in an un-altered state.
  55.  
  56.   -No modifications to the original software may be made and then returned
  57. for public distribution under the original name of the software. This is to
  58. avoid multiple parallel versions of the software to appear.
  59.  
  60. The source code to this software may be used to develop commercial or
  61. non-commercial software for the Amiga. No limitations on this use are imposed
  62. to the exception that the software produced by using this source code must be
  63. substantially different than this software product.
  64.  
  65.  
  66.  
  67.  
  68.                             Bugs and Suggestions
  69.                             ====================
  70.  
  71. If you find any bugs or inconsistencies or have suggestions to improve this
  72. software product, please contact the author at the address mentioned above.
  73. Electronic communication is preferred.
  74.  
  75.  
  76.  
  77.  
  78.                          Calc Support Documentation
  79.                          ==========================
  80.  
  81. Calc, A Programmer's Calculator
  82. -------------------------------
  83.  
  84. Calc provides many functions often needed by programmers. Conversion between
  85. various number bases, control of bit size of operations, and full keyboard
  86. control are features making Calc a very useful addition to a programmer's set
  87. of tools.
  88.  
  89. Calc uses a data entry model similar to the TI calculators. Which is:
  90.  
  91.   {<number> <operation> <number>} <=>
  92.  
  93.   Example: "2" "+" "5" "="
  94.            "3" "-" "1" "*" "2" "="
  95.  
  96. The operations supported by Calc fall into three classes:
  97.  
  98.   · Immediate operations
  99.   · High priority binary operations
  100.   · Low priority binary operations
  101.  
  102. Immediate operations affect the currently displayed value only. For example,
  103. hitting the "+/-" gadget inverts the sign of the currently displayed value
  104. only and does not affect the rest of the current sequence of operations. NOT,
  105. «SH and AS» are other examples of Immediate operations.
  106.  
  107. High priority binary operations involve two numbers and are evaluated
  108. immediately. For example, the multiplication operation gets evaluated as soon
  109. as the second number involved in the operation is entered. This is as opposed
  110. to the behavior of the low priority operations such as addition which are
  111. delayed. This follows the normal conventions adopted in mathematics. For
  112. example:
  113.  
  114.   2+3*6
  115.  
  116. will give 20, and not 36. The multiplication operation gets evaluated before
  117. the addition operation. A few more examples:
  118.  
  119.   2+3*6+7 gives 27
  120.   2+3*6/2 gives 11 (division is a high priority operator)
  121.  
  122. As seen in the above example, when there are several operators of the same
  123. priority in a given expression, they are evaluated from left to right. This
  124. is consistent with the way TI calculators operates.
  125.  
  126. Calc also supports parenthesis in the normal way, which means that
  127. expressions enclosed in parenthesis are evaluated before other expressions
  128. regardless of the priority of the involved operators.
  129.  
  130.  
  131. Running Calc
  132. ------------
  133.  
  134. To start Calc, simply double-click its icon, or invoke it by name from a CLI
  135. or shell. There are no TOOLTYPES options, and no command-line parameters
  136. supported. To quit the program, either click the close gadget, or hit the ESC
  137. key on your keyboard.
  138.  
  139.  
  140. Supported Functions
  141. -------------------
  142.  
  143. All supported functions are listed in the table below.
  144.  
  145. The first column shows the text used on the calculator's gadgets.
  146.  
  147. The second column shows the keyboard equivalents for the gadgets. For
  148. example, hitting "s" or "S" is the same as clicking on the STO gadget.
  149.  
  150. The third column shows the priority of the operations attached to the
  151. gadgets. H is High, L is Low, and I is Immediate.
  152.  
  153. The right hand side of the table gives plain English descriptions of the
  154. operations attached to the gadgets.
  155.  
  156.  
  157.   CA   DEL       I     Clear All, reset to initial state
  158.   CE   Spacebar  I     Clear Entry, reset the current entry back to 0
  159.  
  160.   AND  &         H     Logical AND operation
  161.   OR   | or O    H     Logical OR operation
  162.   XOR  X         H     Logical exclusive OR operation
  163.   NOT  ~ or !    I     Logical negation
  164.  
  165.   «AS            I     Arithmetic shift left
  166.   AS»            I     Arithmetic shift right
  167.   «RO            I     Binary ROL operation to the left
  168.   RO»            I     Binary ROL operation to the right
  169.   «SH  <         I     Logical shift left
  170.   SH»  >         I     Logical shift right
  171.  
  172.   STO  S         I     Store currently displayed  value in backup memory
  173.   RCL  R         I     Recall the value stored in the backup memory
  174.  
  175.   BIN            I     Puts the display into Binary (base 2) mode. Only the
  176.                        way the numbers are displayed is affected, all
  177.                        internal computations perform exactly the same
  178.                        regardless of the selected base.
  179.  
  180.   OCT            I     Puts the display into Octal (base 8) mode. Only the
  181.                        way the numbers are displayed is affected, all
  182.                        internal computations perform exactly the same
  183.                        regardless of the selected base.
  184.  
  185.   DEC            I     Puts the display into Decimal (base 10) mode. Only the
  186.                        way the numbers are displayed is affected, all
  187.                        internal computations perform exactly the same
  188.                        regardless of the selected base.
  189.  
  190.   HEX            I     Puts the display into Hexadecimal (base 16) mode. Only
  191.                        the way the numbers are displayed is affected, all
  192.                        internal computations perform exactly the same
  193.                        regardless of the selected base.
  194.  
  195.   =    = RETURN  H     Performs all pending operations and yields a result.
  196.                        This will close any opened parenthesis for you before
  197.                        performing the calculations.
  198.  
  199. Additional keyboard support includes 0-9 and A-F to enter numbers, + - * / to
  200. perform operations, and ( ) to isolate expressions. As well the ESC key can
  201. be used as a synonym to clicking the window close gadget to quit the program.
  202.  
  203.  
  204. Calc Menus
  205. ----------
  206.  
  207. Calc has a menu strip which contains only one menu. Keyboard shortcuts for
  208. the menu are accessed using the right Amiga key and another key. See the menu
  209. display to learn of the keyboard shortcuts.
  210.  
  211. The first section of the menu allows you to select the bit size used to
  212. perform any operations. This corresponds directly to the 68000 bit sizes. If
  213. you do not know what bit sizes involve, leave this setting to 32.
  214.  
  215. The second section of the menu allows you to control whether or not you are
  216. working with signed or unsigned values. Again, this corresponds directly to
  217. the 68000's view of the world.
  218.  
  219. Finally, the About... menu item allows you to display the version number and
  220. a copyright message.
  221.  
  222.  
  223.  
  224.  
  225.                             Modification History
  226.                             ====================
  227.  
  228. Version: 1.00
  229. Author : Martin Taillefer
  230. Date   : 20-Mar-89
  231. Changes: Original
  232.  
  233. Version: 1.01
  234. Author : Martin Taillefer
  235. Date   : 25-Mar-89
  236. Changes: Memory overwrite bug fixed. Would cause the program to crash when
  237.          recompiled with modifications! Added a few more keyboard shortcuts.
  238.          Made minor adjustments to the internal layout to improve consistency
  239.          of the source.
  240.  
  241.  
  242.  
  243.  
  244.